Format, functie

       

Geeft als resultaat een Variant (String) met een expressie in de notatie die is opgegeven in een notatie-expressie.

Syntaxis

Format(expressie[, notatie[, eerstedagvanweek[, eersteweekvanjaar]]])

De syntaxis van de functie Format bestaat uit de volgende onderdelen:

Onderdeel Beschrijving
expressie Vereist. Elke geldige expressie.
notatie Optioneel. Een geldige benoemde of door de gebruiker gedefinieerde notatie-expressie.
eerstedagvanweek Optioneel. Een constante die de eerste dag van de week aangeeft.
eersteweekvanjaar Optioneel. Een constante die de eerste week van het jaar aangeeft.

Instellingen

Voor het argument eerstedagvanweek kunt u de volgende instellingen opgeven:

Constante Waarde Beschrijving
vbUseSystem 0 De NLS API-instelling.
VbSunday 1 zondag (standaardinstelling)
vbMonday 2 maandag
vbTuesday 3 dinsdag
vbWednesday 4 woensdag
vbThursday 5 donderdag
vbFriday 6 vrijdag
vbSaturday 7 zaterdag

Voor het argument eersteweekvanjaar kunt u de volgende instellingen opgeven:

Constante Waarde Beschrijving
vbUseSystem 0 De NLS API-instelling.
vbFirstJan1 1 De week waarin 1 januari valt (standaardinstelling).
vbFirstFourDays 2 De eerste week waarin ten minste vier dagen in het nieuwe jaar vallen.
vbFirstFullWeek 3 De eerste volledige week in het nieuwe jaar.

Notities

Voor de notatie van Doet u het volgende:
Getallen Gebruik vooraf gedefinieerde benoemde numerieke notaties of maak door de gebruiker gedefinieerde numerieke notaties.
Datums en tijden Gebruik vooraf gedefinieerde benoemde datum-/tijdnotaties of maak door de gebruiker gedefinieerde datum-/tijdnotaties.
Datum- en tijdserienummers Gebruik datum- en tijdnotaties of numerieke notaties.
Tekenreeksen Maak uw eigen door de gebruiker gedefinieerde tekenreeksopmaak.

Als u de functie uitvoert op een getal zonder een notatie op te geven, heeft Format dezelfde werking als de functie Str, maar dan internationaal geaard. Een verschil is echter dat positieve getallen die met de functie Format zijn opgemaakt als tekenreeksen, geen voorloopspatie hebben om een plus- of minteken weer te geven, terwijl getallen die zijn geconverteerd met Str die voorloopspatie wel behouden.

Als u een niet gelokaliseerde numerieke tekenreeks opmaakt, moet u een door de gebruiker gedefinieerde notatie gebruiken om ervoor te zorgen dat de waarde er uitziet zoals u dat wilt.

Opmerking Als de instelling van de eigenschap Calendar Gregoriaans is en format de datumnotatie opgeeft, moet de gegeven expressie Gregoriaans zijn. Als de instelling van de Visual Basic-eigenschap Calendar Hijri is, moet de gegeven expressie Hijri zijn.

Als het een Gregoriaanse kalender betreft, verandert de betekenis van de symbolen in de format-expressie niet. Als het een Hijri-kalender betreft, hebben alle datumnotatiesymbolen (bijvoorbeeld dddd, mmmm, yyyy) dezelfde betekenis, maar hebben ze betrekking op de Hijri-kalender. Notatiesymbolen blijven in het Engels, symbolen die resulteren in tekstweergave (bijvoorbeeld AM en PM) geven de tekenreeks (Engels of Arabisch) weer die bij dat symbool hoort. Het bereik van bepaalde symbolen verandert bij een Hijri-kalender.

Symbool Bereik
d 1-30
dd 1-30
ww 1-51
mmm Toont volledige maandnamen (maandnamen in Hijri hebben geen afkorting).
y 1-355
yyyy 100-9666